Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / PostScript Imaging Messages

GXPostScriptDownloadProcSetList

QuickDraw GX sends the GXPostScriptDownloadProcSetList message to guarantee that the needed procedure sets are available on the printer. You can override the GXPostScriptDownloadProcSetList message to modify the list of procedure sets that are needed to print a document. Your override of the GXPostScriptDownloadProcSetList message must match the following formal declaration:

OSErr MyPostScriptDownloadProcSetList (
                        gxProcSetListHdl procSetListHdl,
                        gxPostScriptImageDataHandle hImageData);

procSetListHdl

A handle to a PostScript procedure set list structure. This handle is filled by the GXPostScriptGetDocumentProcSetList message.

hImageData

A handle to the PostScript imaging system structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXPostScriptDownloadProcSetList message to guarantee that each of the procedure sets in the procedure set list is available in the printer. QuickDraw GX first sends the GXPostScriptGetDocumentProcSetList message to determine which procedure sets are needed for the document, and then sends this message to make sure that the procedure sets are downloaded to the printer.

The default implementation of the GXPostScriptDownloadProcSetList message downloads each of the procedure sets to the printer. You can override this message if you want to change the list of procedure sets that are going to be downloaded to the printer.

SPECIAL CONSIDERATIONS

You must forward the GXPostScriptDownloadProcSetList message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

The default implementation of the GXPostScriptDownloadProcSetList message can also return the communications errors that are listed in Table 4-2 on page 4-42.

SEE ALSO

The PostScript procedure set list structure is described on page 4-29.

The PostScript imaging system structure is described on page 4-26.

The GXPostScriptGetDocumentProcSetList message is described in the
previous section.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help